package com.sky.service;

import com.sky.vo.OrderReportVO;
import com.sky.vo.SalesTop10ReportVO;
import com.sky.vo.TurnoverReportVO;
import com.sky.vo.UserReportVO;

import javax.servlet.http.HttpServletResponse;
import java.time.LocalDate;

/**
 * 报表服务接口，定义了各类报表数据获取的方法
 */
public interface ReportService {
    /**
     * 营业额统计报表方法
     * @param begin 统计开始日期
     * @param end 统计结束日期
     * @return 返回营业额统计报表数据对象
     */
    TurnoverReportVO turnoverStatistics(LocalDate begin, LocalDate end);

/**
 * 获取用户统计报表数据
 * @param begin 统计开始日期
 * @param end 统计结束日期
 * @return 返回用户统计报表数据对象
 */
    UserReportVO userStatistics(LocalDate begin, LocalDate end);

/**
 * 订单统计报表数据获取方法
 * 
 * @param begin 开始日期，用于统计的时间范围起始点
 * @param end 结束日期，用于统计的时间范围结束点
 * @return OrderReportVO 返回订单统计报表的值对象，包含订单相关的统计数据
 */
    OrderReportVO ordersStatistics(LocalDate begin, LocalDate end);

/**
 * 根据指定的日期范围获取销售排行榜前10的数据
 * 
 * @param begin 查询范围的开始日期
 * @param end 查询范围的结束日期
 * @return 返回销售排行榜前10的数据，封装在SalesTop10ReportVO对象中
 */
    SalesTop10ReportVO top10(LocalDate begin, LocalDate end);

    void export(HttpServletResponse response);
}
